What does this Ability do?

Plays relaxing ambient sounds (rain, ocean waves, cafe, white noise, etc.) for a user-selected duration. Users can stop playback anytime by saying “stop” (or other exit words), and the Ability exits cleanly back to normal OpenHome flow.

Suggested Trigger Words

• "noise machine"
• "sound machine"
• "sleep sounds"
• "play rain"
• "ocean waves"
• "white noise"
• "cafe sounds"
• "forest birds"

Type

• New community Ability
• Improvement to existing Ability
• Bug fix
• Documentation update

External APIs

• No external APIs
• Uses external API(s):

Testing

• Tested in OpenHome Live Editor
• All exit paths tested (said "stop", "exit", etc.)
• Error scenarios tested (bad input, unrecognized sound name, invalid duration, missing audio file)

Checklist

• Files are in community/noise-machine/
• main.py follows SDK pattern (extends MatchingCapability, has register_capability + call)
• README.md included with description, suggested triggers, and setup
• resume_normal_flow() called on every exit path
• No print() — using editor_logging_handler
• No hardcoded API keys — using placeholders
• No blocked imports (redis, connection_manager, user_config)
• No asyncio.sleep() or asyncio.create_task() — using session_tasks
• Error handling on all external calls
• Tested in OpenHome Live Editor

Anything else?

• Ensure the 15 MP3 files are uploaded into the Ability workspace with the exact filenames referenced in main.py (e.g., cafe.mp3, ocean_waves.mp3, white_noise.mp3, etc.).
• Recommended quick demo flow: trigger → pick sound (“cafe”) → set duration (“one hour”) → stop (“stop”).